home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / graphic / egaclr2.zip / EGACHG.DOC < prev    next >
Text File  |  1986-03-03  |  9KB  |  220 lines
  1.  
  2.  Part of the ENHANCER series of programs EGACHG.COM  Ver. 1.1, Feb 17, 1986
  3.  
  4.      Copyright (C)    I. B. Miller     1985, 1986
  5.  
  6.     If you find this of value and use it please send a
  7.      contribution ($25.00) suggested.
  8.  
  9.  To:  Enhancers              It is suggested that companies contribute
  10.        231 Otonabee Ave.          more for use on more than one machine.
  11.        Willowdale, Ontario, Canada
  12.        M2M-2S9                   Please contact me for a site license
  13.                      Phone (416) 226-9753
  14.  
  15.       EGACHG is a program which provides a means to preset 12 palette color
  16. combinations for EGACLR.COM a companion program which Controls the seventeen
  17. palette registers on the enhanced color card ( Enhanced Graphics Adapter),
  18. 12 different user selected color combinations of any 16 of the 64 colors
  19. available can be made active by use of the Alt key at the same time as any of
  20. the number keys 1 to = at the top of the qwerty keyboard. EGACHG will change
  21. the colors in the Palette registers so that you can see what is available but
  22. unless you use EGACLR these will be lost at the next video reset called by
  23. any program.
  24.  
  25.       The actual colors available to you depend on your actual hardware set
  26. up and so may be different. As an example if you have only a regular monitor
  27. you will have only standard colors though you will be able to swap them around.
  28. In my experience THE limiting factor for text display is the monitor. Though
  29. for graphic display memory size is  also a limiting factor.
  30.  
  31.  
  32. General Information
  33. -------------------
  34.  
  35.     With the Enhanced Monitor color coding is as follows.
  36.  
  37.        Bit                  Hex
  38.        ---                  ---
  39.          1 is    Medium    Blue     - 01
  40.          2 is    Medium    Green     - 02
  41.          3 is    Medium    Red     - 04
  42.          4 is Low    intensity Blue     - 08
  43.          5 is Low    intensity Green  - 10
  44.          6 is Low    intensity Red     - 20
  45.        1+4 is High    intensity Blue     - 09     Low and medium add to give
  46.        2+5 is High    intensity Green  - 12      high    - this is the basic
  47.        3+6 is High    intensity Red     - 24      principle the card works on
  48.  
  49.    Following is the standard color palette combination.
  50.    ----------------------------------------------------
  51.           B  B  G  C  R  M    B  W  G High intensity colors O
  52.           l  l  r  y  e  a    r  h  r --------------------- v
  53.           a  u  e  a  d  g    o  i  e  B  G  C  R  M    B  W  e
  54.           c  e  e  n     e    w  t  y  l  r  y  e  a    r  h  r
  55.           k     n         n    n  e     u  e  a  d  g    o  i  s
  56.                  t         e  e  n     e    w  t  c
  57.                  a            n         t    n  e  a
  58.                              a          n
  59. palette
  60.  register # = 0  1  2  3  4  5    6  7  8  9  A  B  C  D    E  F 10
  61.                                   ^-this is the
  62.                              Seventeenth or in hex it
  63.                            is 10. It really cannot be used
  64.                       in Enhanced Mode because of a seeming
  65.                      bug in the EGA. I cannot believe IBM
  66.                     wanted it that way. Try it and see.
  67.  
  68. How the program works
  69. ---------------------
  70.  
  71.        The program works by loading in the entire EGACLR.COM file
  72.   and then selecting the color controlling bytes which are all near
  73.   the start as initial values for setting the colors. It then follows
  74.   the user through the registersets updating them in memory and
  75.   changing them and the colors on display as the user dictates.
  76.  
  77.        Once the user is finished changing colors to his liking and
  78.   has pressed the End key EGACHG first checks to see how high in the
  79.   sequence of possible EGACLR1.COM to EGACLR99.COM exists on the disk.
  80.   once found it increments this and writes out a temporary file. After
  81.   it has succeeded in the write it renames the original EGACLR.COM to
  82.   EGACLR(whatever #).COM and then renames the temporary file to
  83.   EGACLR.COM. In theory you could change names and have almost unlimited
  84.   numbers of color combinations which can be made active by using these
  85.   variants of EGACLR.COM, but in practice I find it adequate to have
  86.   a few and use the command parameters with EGACLR.COM to change <alt 1>
  87.  
  88.  
  89. Instructions
  90. ------------
  91.  
  92.       EGACHG has been written to work on the EGACLR.COM file on the
  93. same drive as EGACHG.COM. Make sure both are present on the same disk.
  94.  
  95. Important:  Unless you use the EGACLR o command line to turn off auto reset,
  96.          or have not yet activated EGACLR, then EGACLR will proceed to
  97.          not allow this program to show the colors to you. You must
  98.          Deactivate (or not start) EGACLR before starting EGACHG.
  99.  
  100.     The program will proceed to load into itself the EGACLR.COM file.
  101. It will then paint a window on the top half of the screen showing the
  102. palette colors currently in use with EGACLR use of <Alt 1> which
  103. I call registerset # 1. The program will next paint the bottom window
  104. which is the working area and will display the current register of the 17
  105. included in the current registerset as well as the current value in that
  106. register displayed in both decimal and Hex. It will also show the RGB comp-
  107. onents of the color corresponding to that value.
  108.  
  109.       The screen painted appears approximately as follows with of course the
  110. addition of color.
  111.  
  112.  
  113.  EGACHG.COM  A program to change colors to any 16 of 64 available on the EGA
  114.      for use with a companion program EGACLR.COM which must be on same drive.
  115. Register 0      1      2      3       4        5        6        7
  116.      _______________________________________________________________________
  117.     |         |         |          |        |    |     |      |       |
  118.     |         |         |          |        |    |     |      |       |
  119.     | Blocks of colors appear here and change as palette registers change  |
  120.     |________|_______|________|________|________|________|________|________|
  121.     |         |         |          |        |    |     |      |       |
  122.     |         under the control of the operator    |     |      |       |
  123.     |         |         |          |        |    |     |      |       |
  124.     |________|_______|________|________|________|________|________|________|
  125.  
  126. Register 8      9       A        B         C          D        E    F
  127.  Below is current color being worked on.
  128.   ____________________________________________________________________________
  129.   |                                         |
  130.   |                                         |
  131.   |                                         |
  132.   |__________________________________________________________________________|
  133. PgUp & PgDn change registerset, Up & Dn change registers, + & - change colors,
  134. End to quit & save , Q to quit & not save! ,W to write BAT file ,R,G,B to vary
  135. Current Palette Registerset is :  5    10,11,12 are 0,-,=
  136. Current Palette Register is :  01 Color is:   2   Color in Hex is :  02
  137.   Current RGB values are :       R= off
  138.                    G=         med
  139.                    B= off
  140.  
  141.  
  142.     From then on you are in the part of the program that does all the
  143. work and the following keys are the only ones which will do anything.
  144.  
  145.   PgUp        Moves Up one registerset from 1 to 12 then back to 1
  146.   PgDn        Moves Down one registerset from 12 to 1 then back to 12
  147.  
  148.   Up-Arrow  Moves up one Pallette register from 0 to 16 then back to 0
  149.                         0 to 10 Hex
  150.   Dn-Arrow  Moves Down one Pallette register from 16 to 0 then back to 16
  151.                           10 to 0 Hex
  152.  
  153.     +        Increases value in Pallette register from 0 to 63 then back to 0
  154.                               0 to 3F hex
  155.     -        Decreases value in Pallette register from 63 to 0 then back to 63
  156.                               3F to 0 hex
  157.  
  158.     R        Changes Red component of color through off, low, med, high & back
  159.     G        Changes Green component of color through off, low, med, high & back
  160.     B        Changes Blue component of color through off, low, med, high & back
  161.  
  162.     Q        Allows you to quit without creating an output file
  163.  
  164.     S        Standardizes colors In current Registerset
  165.  
  166.     W        writes out a .BAT file to reset colors in Alt 1 . A sample appears
  167.         here.
  168.  
  169.    EGACLR 02A,126,202,337,404,505,614,707,818,919,A1A,B1B,C3C,D2D,E36,F3F,s00
  170.  
  171.   End        Writes out all the values to an EGACLR.COM files while saving the
  172.         previous ones as EGACLR1.COM up to EGACLR99.COM
  173.  
  174.  
  175. Use the End key when you have completed your selection.
  176.    the program will then update EGACLR.COM with your selected
  177.    colors available from <alt 1> to <alt =>.
  178.  
  179. you may then activate the colors by entering   at the DOS prompt
  180.    EGACLR R
  181.  
  182.  
  183. Disclaimer
  184. ----------
  185.      For obvious reasons the user is totally responsible for use of this